LHE SuperFast LZH Extract Utility Ver 1.01E Copyright 1995 by Kunihiko Sadakane sada@is.s.u-tokyo.ac.jp Translated by Hitoshi Ozawa h_ozawa@bekkoame.or.jp http://www.bekkoame.or.jp/~h_ozawa/ 1. Introduction *************************************************************** LHE is an MS-DOS utility for extracting files from files with LZH extenstions (i.e., files compressed by means of the LHA utility). It is fully compatible with LHA versions 0, 1, 4, 5, 6, and d. 2. How to Use ***************************************************************** usage: LHE [exlv] [-qancmx] LZH file [DIR\] [FILES] (a) In place of "LZH file", enter the name of the file with LZH extension whose content is to be extracted or listed. (b) In place of "[DIR\]", enter the name of the directory in which extracted files are to be created. To differentiate it from the file name, please append a "\" or a "/" character to the end of the directory name. If this is omitted, files will be created in the current directory. NOTES: (a) The characters "\" and "/" may be used as directory separators. (b) The LZH extension may be omitted from a file name. (c) The wild card characters "*" and "?" may be used to specify files. (d) The content of a file can be used in the command line by prefixing the file name with an "@" character. (e) If standard input is being redirected, the contents are appended to the end of the command line. 3. Parameters ***************************************************************** (a) Commands [exlv] e Extract files x Extract files and directories (same as LHE e -x1m1) l List contained files v List contained files and directories (same as LHE l -x1) (b) Options [-qancmx] Options all have a format -(option)(number). Example: -m0 (1) -q CRC check files Check for extraction of corrupt files. File corruption is usually also checked for by size, so this option is usually unnecessary. Specifying this option will reduce the extraction speed by 20%. (2) -a Extract with Attributes of files (3) -n Shorten messages -n1 Do not display ellipsis points. -n2 Do not display all messages. When used with an -m option, -m0 will automatically be treated as -m1 When used with an -l option, only file names will be displayed. (4) -c Overwrite all files Overwrite all existing files with the same name. (5) -m -m0 Display a prompt message when the file already exists. An "overwrite(Yes/No/All/Rename)?" prompt will apprear. Enter Y to overwrite the specified file N to skip extraction of this file A to overwrite all remaining files without a prompt R to automatically number file extensions on all remaining files (similar to -m2c1 on remaining files) -m1 Overwrite existing files -m2 Change extensions automatically to number them from 000 to 999. (6) -x Extract subdirectories Create a compressed subdirectory during the file extraction. To minimize the number of rows during the extraction, use -x2. With this option, file descriptions will be displayed in just two rows as necessary. (7) -] Extract only files with different dates (only effective with the -m2 option) If a file already exists, skip it if it has the same date or change the extension of the extracted file if it has a different date. -]m2c1 is the same as -m2 NOTE: (1) If a number is omitted, it will be treated as 1 if the current state is 0 and as 0 otherwise. Example: -m is treated as -m1 if the current state is -m0 and as -m0 if it is not. (2) A "+" or a "-" sign may be used instead of 1 or 0, respectively. Example: -c+ instead of -c1 (3) The default value on all options is 0. (4) Options may be combined. Example: -cm1 (5) Options may be defined as DOS parameters. Example: SET LHE=-q] 4. Suggested Usage ************************************************************ LHE.COM can be used with LHA.EXE to simplify file compression and extraction operations, while retaining the speed of LHE.COM file extraction. (a) Rename LHE.COM as LHA.COM (REN LHE.COM LHA.COM) (b) Move LHA.COM to the same directory as LHA.EXE. Use the LHA command to compress and extract files. If LHA.COM encounters a parameter that it does not support, it will activate and pass the parameters to the LHA.EXE program. NOTE: LHA.EXE can be specified by inserting a ";" or a "=" directly after "LHA". Example: LHA; E *.LZH aaa\bbb.c 5. WARNINGS ******************************************************************* (a) If a file name begins with the character "-", insert an addition "-" to specify that the following character is not an option. Example: To extract from a file named -aaa.lzh, type LHA e --aaa.lzh. (b) If a file name begins with the character "@", insert a "-" before the file name. Example: To extract from a file named @aaa.lzh, type LHA e -@aaa.lzh (c) If the standard output is redirected, the -n0 option will be treated as -n1 and the -m0 option will be treated as -m1. (d) The -]m2 option behaves differently from LHE ver 1.00. (e) Root directory path specification in the LZH file is ignored. (f) A directory may NOT be specified in the [FILES]. (g) Only one output directory may be specified. (h) LHE does not support the 64K dictionary in -lh6-. 6. Releases ******************************************************************* Ver 1.0a - Support extraction with attributes of files Ver 1.01 - Support file listing - Increase extraction speed (10% to 20%) - Fix file if an extraction error occurs - Support switching to LHA.EXE program internally - Change file name not supported by MS-DOS - Support redirection Ver 1.00 - Initial release